STAC Items Details by ID

This section explains how to retrieve metadata for a specific STAC Item using its unique identifier. A STAC Item represents a single geospatial asset (such as a satellite image) and includes spatial footprint, acquisition date, links to asset files, and more.

Endpoint

GET /public/stac/collections/{collectionId}/items/{id}

Include the following header:

x-api-key: YOUR_API_KEY

Example Request (cURL)

curl -H "x-api-key: YOUR_API_KEY" "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66/items/28658e5f-6b73-11ef-812d-19f768344900"

Example Response (Sample):

{
  "type": "Feature",
  "id": "BSG-73-20240830-102222-194727757-ortho.zip",
  "title": "28658e5f-6b73-11ef-812d-19f768344900",
  "collection": "d98629ef-58c5-9af8-714c-ac86b03fba66",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [54.4062737, 24.466125],
        [54.4062737, 24.3901998],
        [54.4880255, 24.3901998],
        [54.4880255, 24.466125],
        [54.4062737, 24.466125]
      ]
    ]
  },
  "bbox": [54.4062737, 24.3901998, 54.4880255, 24.466125],
  "properties": {
    "datetime": "2024-08-30T10:22:22.004Z",
    "name": "BSG-73-20240830-102222-194727757-ortho.zip",
    "giq:layer_type": "RASTER",
    "description": null,
    "giq:ingestion_date": "2024-09-05T10:39:27Z",
    "source_type": "MULTISPECTRAL",
    "giq:source": "BLACKSKY",
    "giq:source_type": "MULTISPECTRAL",
    "giq:source_sub_type": "DEFAULT",
    "layer_type": "RASTER"
  },
  "assets": {
    "rendered_preview": {
      "href": "https://giq.ae/api/map/preview?bbox=54.4062737,24.3901998,54.4880255,24.466125&sourceId=28658e5f-6b73-11ef-812d-19f768344900&width=160&height=160",
      "title": "Rendered preview",
      "type": "image/png",
      "roles": ["overview"]
    },
    "data": {
      "href": "https://minio.giq.ae/.../BSG-73-20240830-102222-194727757-ortho.zip?...",
      "title": "Source File",
      "type": "application/zip",
      "roles": ["data"]
    }
  },
  "links": [
    {
      "rel": "self",
      "href": "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66/items/28658e5f-6b73-11ef-812d-19f768344900",
      "type": "application/geo+json",
      "title": "STAC Item",
      "method": "GET"
    },
    {
      "rel": "collection",
      "href": "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66",
      "type": "application/json",
      "title": "STAC Collection",
      "method": "GET"
    }
  ],
  "stac_version": "1.0.0",
  "stac_extensions": [
    "https://stac-extensions.github.io/view/v1.0.0/schema.json",
    "https://stac-extensions.github.io/sar/v1.2.0/schema.json"
  ]
}

Response Overview

Returns metadata about a specific STAC Item including:

• ID and title
• Geometry and bounding box
• Acquisition timestamp
• Ingestion and layer info
• Asset preview and download links

Response Fields

Field	Description
id	Unique item identifier
title	Human-readable title of the item
collection	Collection ID this item belongs to
geometry	GeoJSON Polygon for item footprint
bbox	Bounding box (min lon, min lat, max lon...)
properties	Acquisition and ingestion metadata
assets	Preview and download asset URLs
links	Navigation links to self and collection
stac_version	STAC specification version
stac_extensions	Applied STAC extensions (if any)

Response Links

Rel	Description	URL Template
self	Link to this specific item	/public/stac/collections/{collectionId}/items/{itemId}
collection	Link to parent collection	/public/stac/collections/{collectionId}

Assets

Key	Description	Type
rendered_preview	Thumbnail or quicklook preview	image/png
data	Downloadable raster or image data	application/zip

Use Cases

• Inspect metadata for an individual satellite image or raster
• Retrieve preview image for display on map
• Programmatically download geospatial assets for analysis
• Trace an item back to its source collection